package cn.ld.module.ai.service.chat;

import cn.ld.framework.common.pojo.PageResult;
import cn.ld.module.ai.controller.admin.chat.vo.conversation.AiChatConversationCreateMyInVO;
import cn.ld.module.ai.controller.admin.chat.vo.conversation.AiChatConversationPageInVO;
import cn.ld.module.ai.controller.admin.chat.vo.conversation.AiChatConversationUpdateMyInVO;
import cn.ld.module.ai.controller.admin.chat.vo.message.AiChatMessageOutVO;
import cn.ld.module.ai.dal.entity.chat.AiChatConversationEntity;

import java.util.List;

/**
 * AI 聊天对话 Service 接口
 *
 * @author fansili
 */
public interface AiChatConversationService {

    /**
     * 创建【我的】聊天对话
     *
     * @param createInVO 创建信息
     * @param userId 用户编号
     * @return 编号
     */
    Long createChatConversationMy(AiChatConversationCreateMyInVO createInVO, Long userId);

    /**
     * 更新【我的】聊天对话
     *
     * @param updateInVO 更新信息
     * @param userId 用户编号
     */
    void updateChatConversationMy(AiChatConversationUpdateMyInVO updateInVO, Long userId);

    /**
     * 获得【我的】聊天对话列表
     *
     * @param userId 用户编号
     * @return 聊天对话列表
     */
    List<AiChatConversationEntity> getChatConversationListByUserId(Long userId);

    /**
     * 获得聊天对话
     *
     * @param id 编号
     * @return 聊天对话
     */
    AiChatConversationEntity getChatConversation(Long id);

    /**
     * 删除【我的】聊天对话
     *
     * @param id 编号
     * @param userId 用户编号
     */
    void deleteChatConversationMy(Long id, Long userId);

    /**
     * 【管理员】删除聊天对话
     *
     * @param id 编号
     */
    void deleteChatConversationByAdmin(Long id);

    /**
     * 校验聊天对话是否存在
     *
     * @param id 编号
     * @return 聊天对话
     */
    AiChatConversationEntity validateChatConversationExists(Long id);

    /**
     * 删除【我的】 + 非置顶的聊天对话
     *
     * @param userId 用户编号
     */
    void deleteChatConversationMyByUnpinned(Long userId);

    /**
     * 获得聊天对话的分页列表
     *
     * @param pageInVO 分页查询
     * @return 聊天对话的分页列表
     */
    PageResult<AiChatConversationEntity> getChatConversationPage(AiChatConversationPageInVO pageInVO);

}
